home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / com / others / figlest / man / readme.3rd < prev    next >
Text File  |  1994-11-23  |  6KB  |  155 lines
  1. About figlet (Frank, Ian & Glenn's Letters) release 2.0,   Dec 4, 1993
  2. ----------------------------------------------------------------------
  3.  
  4. ** changes by t150315@cc.tut.fi in 6.9.1994:
  5. - Removed Makefile and D & E options ;-))).
  6. - Fonts are now searched from a directory pointed by enviroment
  7.   variable FIGLETFONTS, instead of a fixed directory.
  8. - Knows about Atari/Dos *8-bit* international (umlaut) characters.
  9.  
  10. figlet is a program that creates large characters out of ordinary
  11. screen characters.  figlet can create characters in many different
  12. styles and can "smush" these characters together in various ways.
  13. figlet output is generally reminiscent of the sort of "signatures" many
  14. people like to put at the end of e-mail and UseNet messages.  Some
  15. example figlet output is given below.
  16.  
  17. If you like figlet (hey, even if you _hate_ figlet), please send an
  18. e-mail message to spectre@uiuc.edu or figlet@uiuc.edu.
  19.  
  20. [Note: Apple IIGS GNO users having no "C" compiler can contact Jawaid
  21. Bazyar at <bazyar@csn.org> for a pre-compiled GNO version of figlet.]
  22.  
  23. New fonts can be obtained by anonymous FTP from ftp.isu.edu in the
  24. directory pub/figlet/fonts.
  25.  
  26. Check out the FIGLET-L updates, fonts, and discussion list. (You can
  27. set topics so that you only see software update notices, or also new
  28. fonts, or be a full participant in the discussions.) Send email to
  29. listserv@vmd.cso.uiuc.edu with the message
  30.     subscribe figlet-l YOUR NAME
  31. where YOUR NAME should be your name.
  32.  
  33. I would like to point out that some non-Roman fonts are available at
  34. the FTP site as well. As of writing, there are Hebrew and Russian.
  35.  
  36. Files
  37. -----
  38.  
  39. readme.txt -- This file.
  40. figlet.c   -- The figlet source code.
  41. figlet.6   -- The figlet man(ual) page.
  42. <xxx>.flf  -- All files ending in ".flf" are figlet font files.
  43.  
  44. Installing figlet
  45. -----------------
  46.  
  47. First decide in which directories figlet, and the figlet font files
  48. (the ".flf" files) will be stored (usually "/usr/games" and
  49. "/usr/games/lib/figlet.dir") and which will be the default font (we
  50. recommend "standard.flf").
  51.  
  52. Type something like 'gcc -v -O -Wall figlet.c -o figlet' to compile
  53. the program.
  54.  
  55. If the program fails to compile, set OLD_DIR_STRUCTS to 1 in figlet.c,
  56. and type compile again.  (Setting OLD_DIR_STRUCTS to 1 makes figlet use
  57. an older method of reading directories.  On newer systems, this method
  58. will often compile without errors, but will not run properly, so
  59. OLD_DIR_STRUCTS should only be set to 1 if figlet will not compile
  60. otherwise.)
  61.  
  62. If you cannot, or do not want to install the man pages, you can still
  63. probably read it using
  64.     nroff -man figlet.6 | more
  65.  
  66. If space is a problem, the only files you absolutely must have to run
  67. figlet are "figlet" (the executable) and at least one font (preferably
  68. the one you chose to be the default font).
  69.  
  70. We have successfully compliled figlet on the following systems:
  71.  
  72. Hardware              Operating System
  73.  
  74. Sun SPARC             SunOS V4.1.3
  75. SGI Iris 4D/25GT      IRIX V4.0.5
  76. SGI Iris 4D/340VGX    IRIX V4.0.5
  77. SGI Iris Skywriter    IRIX V4.0.5
  78. Cray 2                UNICOS V6.1
  79. Cray Y-MP             UNICOS V6.1
  80. Sequent S81           DYNIX V3.1.1
  81. Convex C240           ConvexOS V10.1
  82. IBM RS/6000           AIX V3
  83. HP 9000/375           HP-UX V7.0
  84. NeXT Mach             NeXTstep V3.0
  85.  
  86.  
  87. Using figlet
  88. ------------
  89.  
  90. At the shell prompt, type "figlet".  Then type, say, "Hello, world!"
  91. and press return.  "Hello, world!" in nice, big, designer characters
  92. should appear on your screen.  If you chose standard.flf to be the
  93. default font, you should see
  94.  _   _      _ _                             _     _ _
  95. | | | | ___| | | ___    __      _____  _ __| | __| | |
  96. | |_| |/ _ \ | |/ _ \   \ \ /\ / / _ \| '__| |/ _` | |
  97. |  _  |  __/ | | (_) |   \ V  V / (_) | |  | | (_| |_|
  98. |_| |_|\___|_|_|\___( )   \_/\_/ \___/|_|  |_|\__,_(_)
  99.                     |/
  100. (By the way, the above is meant to be diplayed in a monospaced font.)
  101. Then type something else, or type an EOF (typically control-D) to quit
  102. figlet.
  103.  
  104. Now you can send the output of figlet to a file (e.g., "figlet > file")
  105. and e-mail it to your friends (who will probably say, "Wow!  It must
  106. have taken you hours to put that together!")
  107.  
  108. To use other fonts, use the "-f" command line option.  For example, if
  109. you had said "figlet -f smslant" above, you would have seen
  110.    __  __    ____                         __   ____
  111.   / /_/ /__ / / /__      _    _____  ____/ /__/ / /
  112.  / __  / -_) / / _ \_   | |/|/ / _ \/ __/ / _  /_/
  113. /_/ /_/\__/_/_/\___( )  |__,__/\___/_/ /_/\_,_(_)
  114.                    |/
  115.  
  116. Here are some other useful command line options:
  117.  
  118. -c  center -- centers the output of figlet.
  119. -t  terminal -- figlet asks your terminal how wide it is, and uses
  120.     this to determine when to break lines.  Normally, figlet assumes
  121.     80 columns so that people with wide terminals won't annoy the
  122.     people they e-mail figlet output to.
  123. -D  Deutsch -- switches to the German character set.  Turns `[', `\'
  124.     and `]' to umlauted A, O and U, respectively.  `{', `|' and `}'
  125.     turn into the respective lower case versions of these.  `~' turns
  126.     into s-z.
  127. -p  paragraph mode -- eliminates some spurious line breaks when piping
  128.     a multi-line file through figlet.
  129. -F  Fonts -- lists the available figlet fonts.
  130. -v  version -- prints information about your copy of figlet.
  131.  
  132. For in-depth explanations of these and other otions, see the man page.
  133.  
  134.  
  135. Other Stuff
  136. -----------
  137.  
  138. Although you don't have to design your own fonts to use figlet, we'd
  139. certainly like it if lots of people did make up new figlet fonts.  If
  140. you feel like giving it a try, see the "FONT FILE FORMAT" section of
  141. the man page.
  142.  
  143. See "Other Things to Try" in the EXAMPLES section of the man page
  144. for...  well... other things to try.
  145.  
  146.  
  147. Authors
  148. -------
  149.  
  150. figlet was written mostly by Glenn Chappell <ggc@uiuc.edu>.  The
  151. author not being an e-mail fanatic, most correspondence (bug reports,
  152. rave reviews, etc.) should be directed to his secretary (who is
  153. definitely an e-mail fanatic), Ian Chai <spectre@uiuc.edu> (or
  154. figlet@uiuc.edu).
  155.